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PREFACE 


This manual describes the Operating System/32 (0S/32) Edit 
Utility, its commands, error messages, and the basic editor 
concepts. This manual is especially written for the new user. 


Chapter 1 introduces Fait and outlines the system requirements. 
Chapter 2 describes building, loading, and starting the editor 
from the system console and an MTM terminal. Chapter 3 describes 
all the Edit commands and gives examples of their use. Chapter 
4 guides a user through a sample editing session. ) 


Appendix A summarizes Edit commands. Appendix 8B is a message 
Summary. Appendix C contains ASCII-EBCDIC conversion tables. 


This manual replaces 29-576 RO1. Tt is rewritten and 
reorganized. The following commands are added: AFTER, AGAIN, 
BEFORE, BOTTOM, DONE, HELE, MOVE, NOFIND, OPTION COMMAND, OPTION 
SCREEN, RULER, SCREEN, SUBSTITUTE, TOP, and TRUNCATE. Various 
changes are made to existing commands. Edit now supports full 
hexadecimal editing. 


These publications can be used in conjunction with this manual: 


PUBLICATION 
MANUAL TITLE NUMBER 

Operating System/32 (CS/32) Cperator 
Reference Manual $29-574 
Operating System/32 (0S/32) Accounting 
Facility Reference Manual 48-007 
Operating System/32 (0S/32) Link Reference 
Manual 48-005 


es 


HOTICE 
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The Perkin-Elmer OS/32 Link will replace the Perkin-Elmer 0S/32 
Task Establisher Task (TET). Link is supported by OS/32 805.2 
and higher. 


For current users of TET, see the OS/32 Link Reference Manual for 
a comparison of Link and TET commands and a TET command 
description. 


—_ a2 <a: 2 =e we = ob <a <P ae <n <n ae <8 ae ee ee ee eee ee ee ee om << ~<a ae ee 2 owe we a ee oe eee ee ee ee ee ese ee ee 


48-008 ROO 46/80 v 


CHAPTER 1 
OPERATING SYSTEM/32 (OS/32) EDIT 


1.1 INTRODUCTION 

OS/32 Edit is a disc-based editor that operates on an  0OS/32 
system and on an OS/32 system with MTA. Edit can be executed in 
an interactive or batch environment and editing is performed on 
a line-by-line basis. Tata can be appended to a file, altered, 
and saved via the commands described in Chapter 3. 

1.2 EDIT REQUIREMENTS 

These system resources are required for Edit: 

® The minimum hardware required for OS/32 

e CDisc devices 

e Temporary file support 

The pure segment of the editor requires 32.50kbd of memory. Each 
impure segment requires a minimum of 9.25kbD of memory. This 
Minimum amount includes 4kb for a buffer in which the editor 
Maintains tables. 

1.3 SYSTEM ENVIRCNMENTS 

Edit can be executed in an interactive or batch environment which 
is determined by the user-srecified command input device in the 
START command. See secticn 2.4. 

1.3.1 Interactive Environment 

In an interactive environment, a dialogue is carried on between 
the user and the systen. Edit waits for your command, processes 
it, then prompts you for the next command. Commands are entered 
interactively through such devices as a CRT or teletype. There 
acre two modes of operation in an interactive environment: 

e Ccmmand mode 


@ Input mode 


During command mode, editing is performed on a copy of your file 
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residing in ME MOLY. You can change, alter, delete, and locate 
data that has been previously contained in the file. 


During input mode, you can change existing data and enter new 
data in a file. Entering a null line (a carriage return being 
the only new information cn an input Line) transfers you from 
input node to command mode. 


Te3e1e1 Proapts 


In command mede, a greater than sign (>) is displayed to the list 
device. It is a command prempt informing the user to enter a 
cecmmands: 


> 


When a command is typed in, followed by a carriage return, Edit 
interprets the command and ferforms the operation. Some commands 
are repeated every time the carriage return is depressed until a 
new command is entered. 


Input mode causes a line prompt to be displayed. The prompt 
character is preceded by a line number: 

> 
2 > 
In input mode, Edit will continue te display line prompts until 
a null line is entered. Edit will then return to command mode. 
4123-122 Control Characters 
Some interactive devices allow you to modify data before it is 


transmitted to the buffer via control characters. Table 1-1 
lists the control characters and their functions. 


TABLE 1-1 EDIT CONTROL CHARACTERS 


=> — @p =p aR am «am ae ae <a a oe oe oe oe oe ae ee ae a ee ee Sw ees ee ee ee ee «ee ee ee ee ae ee ee ee ee ee ee ee ee ee 


| CTRL X | Yoids line being typed ECR tae Lily 
l | MODEL 1100, 1200] 
| | | VOU, Carousel | 


| <== | Deletes character directly | CRT, TTY, 
| | preceding symbol | Carousel 
(ica a gg cg a IE a | 
Cra. bk | Moves curscr back 1 space, | CRT, MODEL 1100, | 
| deleting character in that | 1200 YDU, | 
| | space | Carousel 
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12-322 Batch Environment 

In a batch environment, a sequence of Edit commands is input from 
a disc file, card reader, or magnetic tapde device and is 
Processed as a background task. The list device is specified in 
the START command. User commands, Edit responses and messages 
are output to the list device. 


If an error occurs during batch processing, execution of the 
current job is haited and this message is displayed: 

-END OF TASK CODE = 2 
Norcmal completion is indicated by the following message: 


=~END OF TASK CODE. = 0 


1.4 FILES 


Data is retained by saving it to a file residing on a device. 
Biles are identified by a unique name and specified by file 
descriptors according to the standard OS/32 format. 


16 4< 4 File Descriptors 


File descriptcrs, abbreviated as fd, are entered in a Standard 
format. 


Format: 


— [filename] [- [ext] | [/ file class] 
dev: 


Parameters: 


Cd 


voln: is a 1- to 4U-character alphanumeric string 
specifying the name of a disc volume. The 
first character must be alphahetic and the 


remaining, alphanumeric. If the volume name 
is omitted, the default is the system or user 
volume. 

dev: LS a T= to U-character alphanumeric string 
Specifying a device name. The first character 
must be alphabetic and the remaining, 


alphanumeric. 
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filename is a 1- to 8-character alphanumeric string 
specifying the name of a file. The first 
character must be alphabetic and the 
remaining, alphanumeric. If a filename is 
Specified when a device name is specified, the 
filename is ignored. 


eext is 2 1- to 3-character alphanumeric string 
specifying the extension to a filename. 


file class is a t-echaracter alphabetic string specifying 
the type cf file class. The file class types 
are: 


P for private file 
SG for group file 
S$ for system file 


T&£ the file class is omitted, the default is 
P in an MTM environment, and S in an operating 
system environment. 


1-5 EDIT FEATURES 

1.521 ASCII and Hexadecimal Editing 
Edit provides two modes of editing: 
® ASCII node 

®@ Hexadecimal (hex) mode 


In ASCII mode, Edit interprets character strings as they are 
represented. In hex mode, Edit interprets character strings as 
fairs of hexadecimal digits. All editor commands can be used in 
hex as well as ASCII mode. Choice of nodes is specified in the 
OPTION command. ASCII-~=EBCDIC conversion tables are in Appendix 
Cx 


1.5.2 Identifying Data 
1.5.2.1 Line Numbers 


Line numbers provide a convenient way to identify lines of data 
during an editing sessicn. Edit assigns line numbers beginning 
with 1, incremented by one, up to line number 99999. The APPEND 
command assigns line numbers in increments of one, and is used to 
enter new data. The INSERT, REPLACE, and INCLUDE commands insert 
new information into existing data at a specified position. Line 
Mumbers for inserted lines have a decimal part following tne 
integer number. 
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The decimal part is generated by incrementing the existing line 
mumber by OV The line number of each inserted line is .01 
greater than the previous line number. Incrementing stops if a 
new line number is the same as an existing line number. Thus, 
several lines can exist with the same line number. In this 
“situation, if a line number parameter is used to specify a line, 
the first line with the duplicate number following the current 
line is assumed. Other lines can be located by uSing the plus 
(+) or minus (-) commands to positicn the desired lines. Enter 
a SAVE command to renumber the entire file. 


1252-2.22 Character Strings 

A line of data can be identified by specifying a sequence of 
unique characters within the line. When a String 1s specified in 
a command format; the string identifies a line to the editor. 
When the specified string is not unique to one line being edited, 


the first line containing the string is assumed to be the desired 
line. 


Format: 
/string/[col] 
Parameters: 
/ is a nen-alphanumeric character delimiting a 


string. See section 1.5.2.4. 


string is a unique, alphanumeric sequence of 
characters. 


col is a decimal number from 1 to 256 specifying 
the starting cclumn location of a character 
string. 


1-5-2-3 Current Line 


During editing, the editor maintains a line pointer positioned at 
the current line. Edit commands with no range parameter 
specified operate on the current line. Ahen changing from input 
mode to command mode, the current line is the last line entered 
from the command device; when changing from command mode to input 
mode, the current line is the line following the last line 
edited. 
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72-5.2.4 Delimiters 

A delimiter is a non~alshanumeric character that separates 
character String] 18 an incut tine. Delimiters allow the aditor 
to recognize the beginning and end Of a String. Any 
non~alphanumeric character is valid except: 

® semicolon 

e comma 

® minus sign 

® blank 


® a character that appears in the string itself 


The slash (/) is used to represent a delimiter in this manual. 


47-5.2.5 Ranges 


A range refers to specific line numbers in a file, or unique 
character strings that identify specific line numbers in a file. 
A minus sign is used to separate range arguments. 


Format: 
line no, Line non 
/string, / [col] /string,/ [col] 


Parameters: 


line no; is the line or beginning line of a range to be 
operated on. v 

line no, is the ending line of the range to be operated 
On. 

{ is a nen-alphanumeric character delimiting a 
Ser Lads 

string, is a unique, alphanumeric character string of 


beginning string of a range to be operatad on. 


strings is a unique, alphanumeric character string ofr 
ending string cf a range to be operated on. 


col is a decimal number from 1 t9 256 indicating 
the coluan locations of string, and strings. 
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Functional Details: 


Any combination of range arguments is permitted. Sie he Me a searches 
the file for the specified lines or strings. After a match is 
made, the actual function of the command is performed. 


Data is operated on beginning with the first line or string 
specified, and continuing through the last line or string 
specified. If the second argument is omitted, all lines from the 
line or string specified to the end-of-file are operated on. Lf 
the first argument is omitted, all lines from the current line to 
the line or string specified are operated on. 


If the entire range parameter 15 omitted, the default is the 
current line. 
Examples: 
1-16 indicates lines 1 through 16 
inclusive. 
range parameter specifies current line only. An 
omitted exception to this is the SAVE 
command where, 1f the range is null, 
all lines of data are still saved. 


4 indicates line 1 only. 


-10 specifies current line through line 
10 inclusive. 


- specifies current line through 
end-of-file inclusive. 


1- indicates line 1 through 
end-of-file. 


/CHARS/-5 is the line where the character 
String CHARS appears to line 5. 


/CHARS/-/TELN/ are the lines identified by the 
first occurrence of CHARS to: tie 
first occurrence of DELN. 


14542256 Carriage Return 


The carriage return transmits a line of data to be processed and 
Switches an Edit user from ineut mode to command mode. 
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1.5.3 Formatting Data 


Edit presets options that centrol the data format of a file. 
These defaults allow the user to create a file without having to 
specify line length, line numbers, etc. See section 3.19. 


125.321 Line Length 


The maximum number of characters allowed in each line is called 
line length. When appending to anew file i.e. no GET command 
is issued prior to the APPEND, the record length defaults to 38:0 
bytes. If a GET is issued to an existing disc file and OPTION 
LENGTH (see OPTION command) was not specified, the length 
defaults to the record length of the file. The maximun 
characters per line is 256. You can specify line length via the 
length parameter in the OFTICN command. 


If the number of bytes per record is less than the editor line 
length, each line is sadded with blanks. You can specify a 
column number, via the TRUNCATE command, indicating the column at 
which trtuncation will eccur. Characters displayed beyond the 
specified column are lost when a line of data is expanded. The 
default is column 73. 


1.5e3-2 Text Display 


Several commands cause data to be displayed with the appropriate 
line number. The decimal portion of the integer is only output 
if it is not equal to zero. Trailing blanks are not output. 
Data is continued on the next line, up to 80 characters, when 
necessary. 


When the tab option is in effect, data is displayed according to 
column settings defined by the tab option. See section 1.5.3.3. 
When the mode specified in the OPTION command is hexadecimal, all 
data is displayed in hexadecimal format. 


12-5.3.3 Tab Settings 


Tab control causes data te be aligned at preset vpositions and 
frees the user from manually spacing data. 


The tab parameter of the GPTION command allows the user t9 set 
tabs and designate a tab control character. The tab settings are 
used only when text is entered at the command device. The editor 
expands the line entered according to the tab control character 
and settings, and retains the line in its expanded form. See 
section 3.19. 
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1-5.-3.-4 Column Display 

Edit displays a ruler at the user's console via the RULER 
command. Use this asa guide to determine where columns begin 
and end. 

Example: 


>RULER 


0 1 Z 3 4 5 6 
1234567890123456789012345678901234567890123456789012345678901234567 


When hexadecimal is entered as the mode in the OPTION command, 
column numbers are outout in hex. For example: 


>RULER 


010203040 5060708090A0BOCODOEOFO101112131415161718191A1B1C1D1E1F 202122 


1.6 VERIFICATION 


Lines that are located, changed, OL altered ace automatically 
displayed to the list device. Editing verification can be turned 
off via the noverify opticn in the CPTION command. 


1.7 COMMANDS 


Commands are entered fcllowing the command prompt and are 
transmitted for processing ty entering a carriage return. 


17.1 Edit Command Syntax 


Multiple commands can be entered on one line if they are 
separated by semicolons (;). An exception to this is the AGAIN 
command which must appear by itself on a command line. when 
multiple commands are entered on the same line, they are executed 
sequentially. If an error cccurs, any subsequent commands on the 
line are igncred. 


In a batch environment parameters can be continued by entering a 
comma as the last character and continuing the parameters on the 
following iine. 


1.7.2 Statement Syntax Conventions 


These statement syntax conventions are used in all command and 
instruction formats: 


Capital letters, must be entered exactly as shown 


parentheses, and 
Punctuation marks 
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Lowercase letters 


n 


Underlining 


PAUSE 
Elligsis 


Params,eee,bDarams 


Lettering with shading 
n 


Braces 


7 


Brackets 


7 


Commas 


Braces inside brackets 


Comma preceding braces 
inside brackets 


on 


140 


represent parameters or information 
provided by the user 


indicates only the underlined por- 
tion of the entry is required 


represents an indefinite number of 
parameters or a range of parameters 


represents a default option 


represent required parameters from 
which one must be chosen 


represent an optional parameter that 
Can be chosen 


separate farameters and substitute 
Missing positional parameters 


represent optional parameters from 
which one can be chosen 


must ce entered if one of the 
optional Parameters is chosen 
However, if the parameters are not 
positional and the first parameter 
of the statement is not chosen, the 
Parameter specified as the first is 
not preceded by a comma. 


H8=0038--k00. “6730 


Comma inside brackets must be entered if the optional 


parameter is chosen 
. 
Comma outside brackets must be entered in place of Missing 
except last parameter positional parameters and 6 
Separate optional parameters that 
are chosen. Commas are omitted for 
; , r trailing parameters and a comma must 


be entered with the last specified 
rarameter. 


Equal sign separating must be entered to associate 
keyword from farameters Parameter with keyword 


KEYWCRD=raram 


1.8 MESSAGES 


Four types of messages are output to the command device during an 
Edit session: 


e Messages fFertaining to incorrect syntax 
@ Messages pertaining to incomplete execution of a command 


e Messages pertaining to incomplete command execution because of 
a more serious error 


@ Information messages 


Messages indicating incorrect syntax are preceded by a question 
mark (?) and are generated when the editor cannot recognize a 
command or its parameters. The editor does not attempt to 
execute the specified command. 


Execution messages are preceded by an exclamation point (!) and 
are cutput during executicn. Determine where in the file 
execution stopped, correct the error, and re-~execute the command. 


Messages preceded by two exclamation points (!!) denote a 
serious problem. In scme cases, the only way to recover is to 
attempt to save the current data to a file different from the 
source file, end the session, and restart. 


Infcrmation messages are cutput to help you in an editing 
session. Some examples of these messages are reminders to save 
text and indications that a fuaction has completed normally. 


For a complete list of messages and meanings see ADDendix 8. 
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CHAPTER 2 
BUILDING, LOADING, AND STARTING THE EDITOR 


2-1 BUILDING EDIT AS A SYSTEM IMAGE LOAD MODULE 


This sequence of commands builds the shared HELP segment and Edit 
task as a system image load module: 


LOAD LINK 

START 

ESTABLISH SHARED, ADDR=EQ000 Build the HELP segment 
INCLUDE HELP 

jig i be 

MAP PR:,AULDR,ALPHA 

BULL: CE LP 


ESTABLISH TASK Build the Edit task 
CPTION SEG,WORK=100,SYS=FFFFF 

SHARED HELP i 

INCLUDE ECIT 

MAF PR:,ALDR,ALPHA 


BUILD EDIT 
END 


For an explanation of these commands, see the Operating System/32 
(OS/32) Link Reference Manual. 


2e2 LOADING EDIT FROM AN MIM TERMINAL 
After building the image load module, EDIT.TSK, the module can be 
loaded into memory with this command: 
Formats: 
LOAD fd[,segsize increment] 


Parameters: 


fd is the file descriptor of the Edit load module 
to be loaded into memory. 
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segsize ls a decimal number in Xb Specifying the 
lacrement additicnal memory to be added to the task's 
impure segment. 


Functional Details: 


When the Edit load module is loaded into memory, the systen 
displays .an asterisk (*) prompt, indicating the editor can be 
Started. 

In order to successfully load the task, the shared HELP segment 
must be on the volume under the account number from which tne 
task is to be loaded, or on the default system volume under 
account number OQ. 

2e3 LOADING EDIT FROM THE SYSTEM CONSOLE 


The LCAD command loads Edit from the system console. 
Fornat: 

LOAD taskid|, [ed][,segsize increment]| 
Parameters: 


taskid specifies the name of the nodule after it is 
loaded into the foreground segment of memory 
as the currently-selected task. 


rake is the file descriptor of the editor image 
load mcdule to be loaded into memory. Re Ths 
parameter is Omitted, the default is 
taskid.TSK. 

segsize is a decimal number in kb specifying the 

increment additicnal memory to be added to the task'’s 


impure segment. 


Functional Details: 


The system sets Edit as the currently-selected task. when the 
system displays the asterisk promet, the editor can be started. 
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2-4 STARTING EDIT 


The START command starts Edit. 
Format: 

START [,COMMAND=fd,] [,LIST=fd2 | 
Parameters: 


CCMMAND= fd, specifies the input device from which 
commands are to Fe entered. If this parameter 
is omitted, the default is the console device 
(CON:). If the specified command input device 
is interactive and the LIST parameter is 
omitted, all output data and messages are sent 
to the command device. If the command inbdut 
device is batch, the LIST parameter must be 
specified. 

LIST= fd5 specifies the output device to which 
output data is sent. If this parameter is 
Omitted and the command device is interactive, 
the output data and all messages are sent to 


the ccmmand device. If the command device is 
batch, the LIST parameter must be specified. 


Functional Details: 


If toth parameters in the START command are omitted, the default 
is the console device (CON:). 


Error Messages: 


fINVALID COMMAND DEVICE 


The file or device specified as the command . device of the 
START command is syntactically incorrect. 


FINVALID LIST DEVICE 


The file or device specified as the list device is 
syntactically invalid. 
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fDUPLICATE START OPTION 


A command or list paraneter was entered more than once. 


ISYNTAZ ERROR IN START OPTICNS 


The command or list faragreter was entered 


fLlst CPIITCN CuITIED = BATCR MOLE 


A non~interactive device was specified as 
and the list fFarameter sas not specified. 


tUNABLE. TO ASSIGN: List DEVICE 


The file cr device specified as the list 
assigned. 


“END OF TASK CODE=7 


The editor cannot proceed without valid 


Code 1 indicates abnormal job termination. 


incorrectly. 


the command device, 


device 


cannot 


be 


START parameters. 
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CHAPTER 3 
OPERATING SYSTEM/32 (05/32) EDIT COMMANDS 


3.1 INTRODUCTION 


This chapter describes the fcllowing OS/32 Edit commands: 


AFTER 
AGAIN 
APPEND 
BEFCAE 
BOTTOM 
CHANGE 
CCLUMN 
DELETE 
DONE 

END 

FIND 

GET 

HELF 
ENCLUDE 
INSER! 
MOVE 
NOFIND 
CPTION 
PAUSE 
REPLACs 
RULES 

SAVE 
SCREEN 
SEND STOP 
SUBSTITULS 
TOP 
TRUNCATE 
bie 6:8 

(+) PLUS SIGN 
(-) MINUS SIGN 
LINt NUMBER 
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AFTER COMMAND 


The AETER command inserts a new character string immediately 
after a user-specified character string in a line of data. 


For 


mat: 


line no; 


AFTER /string/newstring |/ 


line 


/string,/ [col] 


NOg 


/string,/ [col] 


Parameters: 


string 


col 


newstring 


line no; 


line non 


String. 


is a nen-alphanumeric character delimiting a 
string. The biaaAKy minus sign, comma, 
semicolon, and any character that appears in 
the string itself cannot be used. 


is a sequence of unique alphanumeric 
characters. The new string is inserted after 
this string. 


is a decimal number from 1 to 256 indicating 
the Starting ccolumna location of string, and 
string>. 


2s a sequence of unique alphanumeric 
characters to be inserted after the specified 
character string. 


is the line number or first line number of a 
range of lines where the newstring will be 
inserted after the specified string. 


is the ending line number of a range where the 
newstring will be inserted after the specified 
StL L190. 


isa UAlLd@ue: Cheracter string: of ‘16st Unique 
character string of a range which deternines 
where in the file the naewstring will be 
inserted after the specified string. 
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String> is the ending unique character string of a 
range which determines where in the file the 
newstring will be inserted after the specified 
Strings 


Functional Details: 


If the inserted string eproduces a line longer than the 
established line length, or if the portion of data to the left of 
the truncate column is expanded, the following message is 
disclayed when any non-blank characters are lost: 


{NON-BLANK CHARACTERS LCST 


Examples: 


PAELTERS UL ISEC/ EL LES 2 


After the character string DISC, insert character string 
FILE in line 2. 


DAFTER/CDISC/SFILE/S2-/TAPE/S 
After the character string DISC, insert character string 


FILE from line Z2 to the first occurrence of the 
character string TAPE. 


PRET ERS OULSC/PLLES 2= 


After the character string DISC, insert the character 
String FILE from line 2 to end-of-file. 
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3-3 AGAIN COMMAND 


The AGAIN command re-executes a previously specified command 
line. 


Forgat: 


~w 


AGAIN 
Functicnal Details: 


Commands that are not re-executed are DELETE, GET, END, and a 
line of data antered vith a line number. When the AGAIN command 
is entered following these commands, the following message is 
displayed: 


7REPEAT CISALLOWED 
The AGAIN command must be the only command on the input line. 
Examples: 


PTY 1-4 

1 This is an example 
2 of how 

3 the AGAIN 

4 command works. 


>AG 
1 This is an example 
2 of how 
3 the AGAIN 
4 command WOrkKS. 
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3-4 APPEND COMMAND 


The APPEND command enters data to a file from the command input 
device. 


Format: 


APPEND 


Functional Details: 


Enter APPEND to either create a new file or add data to an 
existing file. 


In an interactive environment, Edit ooprompts you for data by 
discelaying line numbecs. The first line of data entered is 
assigned line number 1. Subsequent line numbers are incremented 
by 1. The maximum lines allowed ina file is 99999. If data 
already exists, the new informaticn is entered on the line 
following the last line of data. Tab settings are recognized, if 
set during the current editing session. 


In a batch environment, data is entered immediately following the 
APPEND command. Terminate data with the character string 
previously specified in the OPTION command. See section 3.19. 


Examples: 

>AP 
1 >To create 
2 >a new file 
3 >enter APPEND. 
Ly > 

2TY 1- - 
1 To create 
2 a new file 
a enter APPEND. 
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a =P a as Gh ep om oR 


BEFORE jf 


an a> 4 ah = 4) «aD ome 


BEFORE COMMAND 


The BEFORE command inserts a new character string immediately 
befcre a user-specified character string ina line of data. 


For 


mat: 


BEFORE /string/ 


line 


/str 


Parameters: 


string 


col 


newstring 


line no, 


line non 


String, 


line no, 
newstring|/ 
/string,/{col|] 


non 


ing>/[col] 


is a nen-alphanumeric character deliniting a 
string. The blank, minus sign, comma, 
semicolon, and any character that appears in 
the string itself cannot be used. 


is a eequence of unique alphanumeric 
characters. The new string is inserted before 
this string. 


is a decimal number from 1 to 256 indicating 
the starting column location of string, and 
string.,.- 


is a sequence of unique alphanumeric 
characters to be inserted before the specified 
Character string. 


is the line number or first line number of a 
range of lines where the newstring will be 
inserted before the specified string. 


is the ending line number of a range where the 
newstring will be inserted before the 
specified string. 


is a unique character string or first unique 
character string of a range that determines 
where in the file the newstring will be 
inserted before the specified string. 
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string, is the ending unique character string of a 
range that determines where in the file the 
newstring will be inserted before the 
specified string. 


Functional Details: 


If the inserted string produces a line longer than the 
established line length, cr the portion of text to the left of 
the truncate column is expanded, the following message is 
displayed if any non-blank characters are lost: 


INONT BLANK, CHAZACTERS: LOST 


Examples: 


PperORe JELISC/ EL UE 2 


Before the character string DISC, insert the character 
string FILE in line 2. 


>BEFORE /DISC/FILE/S2-/TAEFE/ 
Before the character string DISC, insert the character 


string FILE ftrem line 2 to the first occurrence of 
character string TAPE. 


DREEFORE /UISC/PILE7S 2= 


Before the character string DISC, insert the character 
String FILE from line 2 to end-of-file. 
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3-6 BOTTOM COMMAND 


The BOTTOM command changes the current line pointer to the last 
line of the file. 


Examples: 


>TY 1- 
1 The BOTTOM command 
2 changes the current line pointer 
3 to the last line of the file. 
>TY 1 
1 The BOTTOM ccemmand 
>BOTTOS 
3 to the last line of the file. 
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3.7 CHANGE COMMAND 
The CHANGE command 
data. 


Format: 


CHANGE /oldstri 


replaces a svecified character string with new 


ng/[col],/newstring/ 


line no 
/string/ [col] 
line no; line nog 
/string, /[col] : fstcinds/|ed1| 


Parameters: 


oldstring 


col 


newstring 


line no, 


line no, 


string, 


string, 
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is a nen-alphanumeric character delimiting a 
string. The comma, minus sign, blank, 
semicolon, and any character. in the string 
itself cannot be used. 


is a unique character string to be replaced by 
the newstring. 


is a decimal number from 1 to 256 indicating 
the starting column location of the character 
string tc be changed. 


is a unique character string which replaces 
the oldstring. 


is a line number or first line number of a 
range to be searched for the oldstring. 


is the ending line number of a range to be 
searched for the oldstring. 


is a unigue character string or first string 
of a range that determines where in the file 
the oldstring will be replaced by the 
newstring. 


is the ending unique character strin OF the 


range that determines 


where in the file the 


oldstring will be replaced by the newstring. 


col is a decimal number from 1 to 256 indicating 


the starting column 
String,. 


Functional Details: 
“hen CHANGE is used, all occurrences 


replaced by the newstring. 


If a tab character is containei within a 
the same as any character in the string. 


If the inserted string causes the line 
default, cr the portion of data to 


column is expanded, the following message is displayed 


nen~blank characters area lost: 


([NCH=BLANK CHARACTERS LCST 


Exauples; 


DCHANGE.READ.,- INPUT. e3a7 


location of string, 


of the oldstring 


and 


ale 


String; it is treated 


length to exceed 


the 


the left of the truncate 


sea 


Change all occurrences of READ to INPOT, from line 3 


through end-of-file. 


PCHANGE? READ?,?INPUT?,1-20 


Change all occurrences of READ to INPUT, from line 1 


through line 20. 


>CHANGE.READ.,. «,1- 


Change all occurrences of READ to a space, from line 1 


te end~-of-ftiJle. 


438-008 ROO 


6/80 


3-8 COLUMN COMMAND 


The COLUMN command 
with a new characte 


Format: 


replaces data beginning at a specified column 
crc string. 


line no 


/string/[col] 


COLUMN col no,/string/|, 


Parameters: 


col no 


string 


line no, 


line non 


String, 


string; 


COL 
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line no, jens non 


/string,/[col] (/string2/[col|] 


is a decimal number from 1 to 256 specifying 
the beginning column where data is to be 
replaced. 


is a nen-alphanumeric character delimiting a 
string. The comma, blank, minus sign, 
semicolon, and any character that appears in 
the string itself cannot be used. 


is a sequence of alphanumeric characters, 
specified by delimiters, that replaces the 
data beginning at the specified column. 


is the line number or first line number of a 
range of lines where data will be replaced at 
the specified column. 


is the ending line number of a range where 
data will be replaced at the specified column. 


is a unique character string or the first 
string cf a range that determines where data 
Will be replaced ina file. 


is the ending unique character string of a 
range that determines where data will be 
replaced ina file. 


is a decimal number from 1 to 256 indicating 


| 


the starting cclumn location of string, and 
string,. 


Functional Details: 


If the inserted string eroduces a line longer than the 
established line length, or the portion of text to the Left of 
the truncate column is expanded, the following message is 
displayed if non-blank characters were lost: 


INON=-BLANK CHARACTERS LCST 
Exauples: 


PCOL 16,/83/ 


Change the data starting in column 16 to the character 
string R3 in the current line. 

PCOL 10,/LH/,1~2 
Change the data starting in column 10 to the character 
strins LH, in lines 1 through 20. 

>COL 15,/A2B/,/A1B/~/SASB/ 
Change the data starting in column 15 to the character 
string A2B, from the line containing the character 
string A1B to the line containing the character string 
ASR. 
Change the data starting in column 5 to the character 
string DISC, from the current line to the line 
containing the character string FILE. 


PCOL. S¢/LiSC/;- 


Change the data starting in column 5 to the character 
String DISC from the current line to the end-of-file. 
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3.9 DELETE COMMAND 


The DELETE command deletes data from a file. 


Format: 


DELETE i 


Parameters: 


line no, 


line non 


string, 


string, 


col 


Functional Details: 


If all lines 


displayed: 


or 


line no; \ \ non 
/string,/[col] /string,/[col] 


is the line number or first line number of a 
range to be deleted. 


is the ending line number of a range of ijata 
to be deleted. 


is a nen-alphanumeric character delimiting a 
stringe The comma, blank, minus sign, 
semicolon, and any character apnearing in the 
string itself cannot be used. 


is a unique character string or first unique 
character string of a range that determines 
where data will be deleted ina file. 


is the ending unique character string of a 
range that determines where data will be 
deleted ina file. 


is a decimal number from 1 to 256 indicating 
the column location of string, and string,. 


data are deleted the following message is 


AGi LINES DELETED 
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The DELETE command cannot be re-executed by entering the 


command. 
Examples: 


PEELELE TO=20 


Delete lines 10 through 20, 


POUR LELE 


Delete the current line. 


>DELETE- 
Delete all data from the currenat 
end-of-file. 

P>DELETE 20- 


Delete line 20 through the end-of-file. 


PCELETE /LPR/-/ACC/ 


Delete all lines, from character stEing 
string ACC. 


POELELE: SL Pas. 2210 


Delete all lines, from character string 
eclumn 2 through line 10. 


Line to 


AGAIN 


LPR to character 


LPR beginning in 
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3.10 DONE COMMAND 
The DONE command saves the current file and ends the editing 
session. 
Formats: 
CGNE 


Functional Details: 


This command is equivalent to a SAVE* followed by an END command. 
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3-11 END COMMAND 
The END command ends the editing session and returns control to 
the cperating system. 
Format: 

END 
Functional Details: 
Edit goes to end-of-task with a code of 0 to indicate normal 
termination. 
If data was not saved befcre the END command is entered, the 
following command is displayed: 


REMENDESR = SAVE-YOUR CURRENT TEAT 


The END command cannot be rer-executed by entering the AGAIN 
command. 
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3212 FIND COMMAND 


The FIND command searches for -add occurences of a specified 
string in a given range of a file and displays them to the list 
device. 


Format: 
. no 
'/string/ [col] 
FIND /string/[col] |, 
line no, line non 
/string,/[col] /string,/[col] 
Parameters: 
/ is a nen-alphanumeric character delimiting a 
string. The comma, blank, minus sign, 


semicolon, and any character appearing in the 
String itself cannot be used. 


string is a sequence of alphanumeric characters 
specified by delimiters, to be searched for. 


col is a decimal number from 1 to 256 indicating 
the Starting column location of the specified 
string. 

line no; is the line or first line number of a range of 


lines to be searched for all occurrences of 
the specified character string. 


line no>2 is the ending line number of a range to be 
Searched for all occurrences of the specified 
character string. - 


string, is a unique character string or first unique 
character string of a range that determines 
where in the file to search for the specified 
character string. 


string > is the ending unique character string of a 


range that determines where in the file to 
search fer the specified character string. 
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col is a decimal number from 1 to 256 indicating 
the starting column location of string; and 
string2. 


Functional Details: 


If a tab character is contained within a string, it is treated as 
just another character in that particular string. 


Examples: 


PEIND/ SCH 5 1= 


Find every occurrence of the character string SCH, 
begining in line 1 through end-of-file. 


DPEFIND/SCH/1,5-7 


Find every cccurrence cf the character string SCH, 
beginning in column 1 from lines 5 through 7. 

>FIND /SSCH/,/ACC/2~/CCA/2 
Find every occurrence of the character string SCH, 
beginning at the location of string ACC in column 2 and 
ending at the location of string CCA in column 2. 

>FINE /SCH/,-/CCA/2 
Find every occurrence of character string SCH, beginning 


at the current line and ending at the location of string 
CCA in column 2. 
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3.13 GET COMMAND 


The GET command brings a file off disc and readies it for 
editing. 


Format: 


GET £4 


Parameters: 


fd is the file descriptor of the file being 
accessed. 


Functional Details: 


When a GET command is entered, a copy of the specified file is 
brought off disc. It 1s now opened for editing and data can be 
added, ieleted, inserted, changed, etc. Not until a SAVE command 
is entered, does the updated version of the file replace the 
Original version. If a GET command is entered before the current 
data is saved, a reminder tc save your current text is displayed. 
The GET command is not re-executed by entering the AGAIN command. 


If the record length of the fd is different from the current line 
length, the lines of data are expanded or decreased, accordingly, 
when they are output. When records are expanded, they are padded 
with blanks for ASCII mode. The pad character in hex mode is 
K*OO0'. 


If OPTION LENGTH was issued prior to the GET command, and the 
physical length of the input file is larger than the specified 
line length, the following message is displayed: 


ao 


FILE RECCRD LENGTH=m, CURRENT LINE LENCTH=n 


The variable m is the rececrd length of the input file that was 
established when the GET command was issued. The variable n is 
the line length specified by the user via the OPTION command. 


In a batch environment, the program terminates. In an 
interactive environment, the message is informative only. 
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When the editor is executed as a foreground task, only files with 
account number 0 can be accessed. 


Exasples: 


2GET CHTECT.008 


Get file CHT1EDT.008 on the default user volume. 
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3.14 HELP COMMAND 


The HELP command prints out 


Format: 


mnemonic 
HELF 


Parameters: 


mnemonic is any valid Edit command 
Information will be displayed on how to use 


the ccmmand associated with the 
specified. 


information on how to use Edit. 


mnemonic. 


mnemonic 


causes a list of .all Edit commands to be 


displayed. 


Functional Details: 


The HELP file must be on the default system volume under 


0. 


If carameters are omitted, 


use the HELP command. 


Exagples: 


PHELP- CH 


Fdit prints out information on. Aov 


account 


to 


Displays to the user information on the CHANGE command. 


DPHELP INS 


Displays to the user information on the INSERT 
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command. 
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3-15 INCLUDE COMMAND 


The INCLUDE command copies a line or range of lines of data to 


Specified ovlace ina file. 


a 


Format: 
“line no 
NCLUDE pea) 
/string/[col] 
line no 
/string/[col] 
line no, line non, 
/stting,/[col] /string,/ [col] 
Parameters: 

line no is the Line number after which data will be 
included. If this parameter is omitted, the 
data will b@® included immediately following 
the current line. 

String is a unique character string which determines 
where in the file data will be included. 

/ is a ncn-alphanumeric character delimiting a 
String. The comma, blank, minus sign, 
Semicolon, and any character that appears in 
the string itself cannot be used. 

fq is the file descriptor of the file containing 
the lines to be included. If this parameter 
is omitted, the current file is the default. 

line no, is the line number or first line number of a 


line no, 


range of lines oe be inserted after the 
specified line nunber. 


is the ending line number number of a range of 


line numbdecs to be inserted after the 
specified line number. 
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string, is a unigue character string or first unique 
character String of a range that determines 
the lines to be inserted after the specified 
line number. 


string > is the ending unique character string of a 
range that determines the lines to be inserted 
after the specified line number. 


col is a decimal number from 1 to 256 indicating 
the starting column location of a character 
string. 


Functional Details: 


If the specified range is null, and the fd is omitted, the 
current line is inserted. Tf the range is null, and fd is 
specified, the first line of the specified fd is inserted. 

The lines are not deleted from their original place in the file. 
The inserted lines are assigned the line number they are inserted 
after, incremented by .01. Incrementing stops when the new line 


Number equals the last existing line number. The last line 
number generated is then used for all subsequent lines inserted. 


Examples: 


>INCLUCE 2,,20- 


Include after line 2, lines 20 through the last line of 
the current file. 


PENCLUDE. 2 RY e201» 1 


Include after line 2, all lines of a file named TRY.EDT. 


Include after the current line, lines 25-45 of the 
current file. 

DINCLUCDE,TEXT 100-200 
Include after the current line, lines 100 through 200 of 


the file named TEXT. 


PINCLUDE .END.7,TEXKT,1- 
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Include, following the line containing END in column 7, 
all lines of the file named TEXT. 


DINCLODE 2,TEXT,/BEGIN/2-/END/Y 


Include, after line 2 from the file named TEXT, all 
lines from the line containing the character string 
BESIN in column 2 t0 the line containing character 
string END in colunn 4. 
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3.16 INSERT COMMAND 


The INSERT command inserts cne or more new lines of data Lato a 
file. 


Format: 


‘line no 
INSERT /string/ [eol]> 


current line 
Parameters: 


line no is the line after which data is uO be 
inserted. If line number is omitted, the data 
Will be inserted after the current line. 


/ is a non-alphanumeric character delimiting a 
string. The comma, blank, minus sign, 
semicolon, and any character in the string 
itself cannot be used. 


string is a unique character string that determines 
where in the file data will be inserted. 


col ls a decimal number from 1t0 256 indicating 
the starting column location of the specified 
character string. 


Functional Details: 


When the user enters the INSERT command interactively, the editor 
displays the next fractional line number and a prompt, to 
indicate that a line of data can be entered. Line numbers are 
displayed in increments of .01, following the line specified hy 
the line parameter. Incrementing stops if tne new line number 
equals the next existing line number. The last line number 
generated is then used for all subsequent lines inserted. 


In a batch environment, ingput immediately follows the INSERT 


Contanda. The data is terminated by a character string specified 
in the OPTION command. 


Oe~CG6 ROO! <t7 20 I-75 


Examples: 


ALL |= 

1 This is an 

2 example of 

3 INSERT command works. 
Pins2 

2e-O1>hcw the 

2202> 
2TY 3 

1 This is an 

2 example of 

22-01 how the 

3 INSERT command works. 
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3-17 MOVE COMMAND 


The MOVE command moves a line or range of lines of data within a 


file. 


Format: 


line no 
MOVE 


/string/ [col] 


line no 


/string/[col] 


line no; [ line non 


/string,/[col] 1 hitutine, Steed 


Parameters: 


line no 


string 


line no, 


line no, 


string, 


string, 
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is the line number after which lines of data 
are to be moved. 


is a nen-~alphanumeric character delimiting a 
string. The comma, blank, minus Sign, 
semicolon, and any character within the string 
itself cannot be used. 


is a unigue character string indicating where 
in the files data is to be moved. 


is a line or first line number of a range to 
be moved after the specified line number. 


is the ending line number of the range to be 
moved after the specified line number. 


is a unique character string or first unique 
character string of a range that determines 
the lines to be moved. 


is a unique character string or ending string 
of a range that determines the lines to be 
moved. 


col 1s a decimal number from 1 to 256 indicating 
the starting column location of a character 
String. 


Functional Details: 


After the lines are moved, the original lines of data are 
deleted. The moved lines are assigned the same line number as 
the line they are inserted after, incremented by .01. 


Examples: 
>MOVE 4, 2-3 
After line 4, insert lines 2 through 3. Lines 2 through 


3 are deleted from their original place in the file. 


PEOVE 8, /LISC/<=/ FILE 


After line 4, insert the lines beginning with the line 


containing the character string DISC to the line 
containing the character string FILE. The lines 
identified by the specified character strings are 


deleted from their criginal place in the file. 


2. 
1 This is an 
2 example of 
a MOVE command werkxs. 
a} how the 
>MCVE 2,4 
>TY i- 
7 This is an 
2 example of 
2-01 how the 
3 MOVE command works. 
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3.18 NOFIND COMMAND 


The NOFIND command Searches for all lines in which a specified 
string does ncect appear. 


Format: 


NOFIND /string/ [col] 


line no 


/string/ [col] 


Parameters: 


string 


line no, 


line no, 


string, 


string, 


col 
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line no, line non 
stele sual F mtasttoatit 


is a nen-alphanumeric character delimiting a 
string. The comma, blank, minus’ sign, 
semicolon, and any character appearing in the 
string itself cannot be used. 


is the unique alphanumeric character string to 
be searched for. 


is a line number or first line number of a 
range to be searched for the specified 
character string. 


is the ending line number of a range to be 
searched for the specified character string. 


is a unique character string or first unique 
character string of a range that determines 
the lines to be searched for the specified 
character string. 


is the ending unique character string of the 
range that determines the lines to be searched 
for the specified character string. 


is a decimal number from 1 to 256 indicating 
the starting column location of a character 
Strings 


Functicnal Details: 


Tf the string occurs in every line specified by the line 
parameter, the following message is displayed: 


270CCURS IN ALL LINES 
Examples: 


PNOFIND /DISC/,1- 


numbercr 


Find all lines where character string DISC does not 


occur, from lines 1 to end-of-file. 


PNGEIND: 7ZLEISC/S>. Ie FL LE/ 


Find all lines where character string DISC, beginning in 


column 5, does net occur, from line 1 to the 
containing character string FILE. 


PNORFLND. JOUESC/ SP LLE/S= 290 


line 


Find all lines where character string DISC does not 
Occur, from the line containing character string FILE, 


beginning in column 3, through line 20. 
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3-19 OPTION COMMAND 


The OPTION command sets centrol options for a file. 


Format: 


a} HEXADECIMAL 
OPTION | COMMAND [=fa] FBLOCK |= »MODE|= 
| ASCII 


n fd 
»LENGTH l= t Pe Roe i ; 
ee fd in START command 


fd 
126] 4 
L ae in START cammand 
EOLOG 
|z08 char,col, es | 
-\poRnaa 
CAL 


string n 
/TERMINATOR|=( = ex /SCREEN |= 
"lunspect#ies 23 


Parameters: 


COM= fd is a file containing a command or a 
sequence of commands to be executed when the 
fd is specified. There can be no more than “5 
nested editor command files. 


BLOCK= nm isa number frem 1 to 255 which sets thea 
data blicck size for allocated files. The 
derault. 15. 5. 


MODE= specifying HEXACDECIMAL, Sets the character 
format to hexadecimal. Specifying ASCII, sets 
the character format to ASCII. The default is 
ASCII. 
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LENGTH n sets the line length for data input and 
output. THIS value cannot exceed 256. The 
default value is 80 bytes or the record length 
of the file. 


LIST fd assigns the list device to the specified 
fa% The default fd is the fd assigned in the 
START command. 


LOG fd assigns the log device to the specified fd. 
The default is the fd assigned in the START 
command. 

NOLOG cancels the log option. 

VERIFY causes data that was located, changed, Or 


altered, to be autput to the list device. 1a 
not specified, Yerify is in effect. 


NOVERIFY Cancels the verify cotion. Located, changed, 
or altered lines are not output to the list 
device. 

TAB= tab char is a non-alphanumeric character used 


to set tabs for data formatting. The tab char 
is followed by a decimal number from 1 to 256 
specifying the cclumns where tabs are to be 


set. 
NOTAB clears current tab settings. 
TERMINATOR= is a 1i-~ to 4-character alphabetic string used 


to terminate data input. Terminator can also 
equal a carriage return. 


SCREEN= nh is a number fram : to 23 that sets the 
number cf lines per screen to be displayed. 
The default is 23 lines. 


Functional Details: 


The CPTION command can be entered any time during an editing 
session while in command mode. Parameters can be entered on the 
same line, in any order, segarated by commas. The editor 
processes them sequentially from left to right. Lf Contd tetiag 
parameters are entered in the same statement, the last one 
specified is in effect. The editor disstlays current option 
Settings if the command is entered with no parameters. 
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When the command option is specified, if an end-of-file condition 
occurs when reading the command file, the following message is 
displayed: 


fEND OF COMMAND FILE 


There can be no more than 5 nested editor command files. 


The block option sets the data block size for all subsequent file 
allocations. The block size is a decimal number from 1 to 255; 
the index block size is always 1. The value is used only when a 
file is allocated. At that time, if the block size specified 
exceeds the maximum system block size, allocation fails, and the 
following message is displayed: 


L1FILE ERR, LUn, SIZE ERROR, fd 


In the node option, if ASCII is specified, all characters are 
interpreted pas! ASCTII1<« If HEXADECIMAL is specified, all 
characters are interpreted as hexadecimal digits. Hex and ASCII 
modes are recognized for all Edit operations. When the editor is 
in hex mode, all data must be entered in hexadecimal. Valid hex 


characters are 0-9 and A-F. Special characters such as the 
Carriage return and tab character have no effects. The pad 
character in hexadecimal mode is X‘'0O0‘°%. The corresponding pad 
character in ASCII is $ ae The following example shows hex 
editing: 

*EDIT 

>O KC=HEX 

>AP 


1 POIZ39FFACEDCS8S8ACDCBB7S9EFSS5 
2 PEREPDLECEBEESS SUZ 1265S 5CCACCCEDE 
3 > 
>CH /UDDD/,/0000/,2 
2 FFFFOQOOOREEE88992136553CCACCCEDFOQ0Q0000000000000000000000 
ocococcdo 


ASCII-EBCDIC conversion tables are presented in Appendix C. 


When the tab option is in effect, data is expanded before it is 


stored. It remains in expanded form. The tab option entered 
With no arguments displays the current tab character and 
settings. Up to 20 tabulation points can be sete Once tabs are 
set, new tabs can still be inserted before the next highest 
Setting. Column specification can be omitted to avoid changing 


both column and tab. 


when TAB=FORTRAN is specified, the editor sets tabs in colunns 7 
and 73. Control I is the tat character. 
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When TAB=CAL is specified, the editor sets tabs in columns 10, 
16, 36, and 73. Control I is the tab character. 


The terminator option is generally used in batch environment to 
terminate data input. The terminator characters are positioned 
in columns 1-4 of the input line and are followed Dy blanks or a 
carriage return. In batch environment, when specifying a line 
number command to delete a line, the alternate terminator may 
directly follow the line numberw TERMINATOR=CR specifies that a 
Carriage return is the only valid terminator. 


Exaaples: 


POPTION LENGTH=130 


Sets the line length for data entry and output to 130 
bytes per line. 


>OPTION BLOCK=10 


Sets the data bleckx size to 10 for all Subsequent file 
allocations. 


DP>OFTION 


Disclays all values for current options. 


D>OPTION LI=PR: 


Assigns the printer as the current list device. 


>OPTION MOCE 


Displays the current mode. 


DPOPTION MCDE=H 


Sets the current mode to hexadecimal. 


D>OPTION TAB=3,5,10 


Assigns the $ as the tab character and the tab stops at 
columns 5 and 10. 


POETION TAB 


Verifies the tab character and settings. 
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>OPTION TAB=S,15,TAB 


Adds a third tab Setting to those already in effect and 
displays the tab ortions. 


>OPTION NCTAB 


Clears the current tab settings. 


>CFTICN LCG=fd 


Logs all commands and messages to the file or device 
specified by fd. 


D>CPTION NCLOG 


Cancels the Log cption. Commands and messages are not 
logged. 


>CPTION TERMINATOCR=END 


Defines END, in columns 1-4, as the alternate 
terminator. 


>CPTION VERIFY 


Displays the line modified by the CHANGE command +o the 
log device. 


>OPTION NCVERIFY 


Cancels the Verify option. 
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3-20 PAUSE COMMAND 


The FAUSE command temporarily returns control to the operatiag 
system. 
Format: 

PAUSE 
Functional Details: 
To return to the editor, enter the CONTINUE command. The DAUSE 
command does not delete or change any data in the file, and the 
current line is unchanged. 
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| REPLACE | 
3.21 REPLACE COMMAND 


The REPLACE command replaces existing lines of data with new 
infcrmation. 


Format: 
line no, line non 
REPLACE 7 
/string,/[col] /string,/{[col] 
Parameters: 
line no, is the line number or first line number of a 


range to be replaced. 


line no, is the ending line number of a range to be 
replaced. : 


/ is a neon-alphanumeric character delimiting a 
string. The comma, Dlank, minus sign, 
semicolon, and any character appearing in the 
string itself cannot be used. 


string, is a unigue character string or first unique 
character string of a range that determines 
where in the file data is to be replaced. 


string, is the ending unique character string that 
determines where in the file data is to be 
replaced. 


col is a decimal number from 1 to 255 indicating 
the column location of string, and string>. 


Functional Details: 


In an interactive environment, the editor responds to a REPLACE 
command with a line number as the prompt. The first number is 
the line specified in the command. Succeeding lines are 
discrlayed in increments of .01. 


In a batch environment, input immediately follows the REPLACE 


command. The file is terminated by a specified string in the 
OPTION command. 
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Exagples: 


DREPLACE 4 


Allows the user to re-enter new data on line 4. 


PTY t= 
1 This is an 
2 example of 
3 how the 
4 MOVE command works. 
DREPLACE 
4 >REPLACF command works 
4U.Q1> 
Pit: Gs 
1 This is an 
2 example of 
3 how the 
4 REPLACE command works. 
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; in erev 
3.22 RULER COMMAND ~ “477 BE 


The RULER command displays a ruler to the list device. 
Format: 

RULER 
Functional Details: 


You can enter the RULER cemmand any time duriny command mode of 
an editing session. 


The ruler is output in hex, if OPTION MODE=HEX is specified in 
the OPTION command. 


Examples; 


>RULER 
0 1 2 e. 4 5 6 
1234567890123456789012345678901234567890123456789012345678901234567 


>OPTION MODE=H 


>RULER 
0102030405060 708090A0BOCODOEOF101112131415161718191A1B1C1D1E1F202122 
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3-23 SAVE COMMAND 


The SAVE command outputs data to a file or device. 


Format: 


line no 


fd /string/ [col] 


Parameters: 


tty 
p. 


line no, 


line no, 


string, 


string, 


col 


/string,/[col] 


line no; line non 


/string,/[col] 


is the file descristor of the allocated file 
to which the data is to be saved. 


Saves new data to the current input file. 


is the line number or first line number of a 
range to be saved. 


is the ending line number number of a range to 
be saved. 


is a nen-alphanumeric character delimiting a 
Strings The comma, blank, Minus sign, 
Semicolon, and any character in the string 
itself cannot be used. 


is a unique character string or first unique 
character string of a range that determines 
the data to be saved. 


is the ending unique character string of a 
range that deternines the data to be saved. 


is a decimal number from 1 to 256 indicating 


the starting column location of String ; and 
Strings 
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Functicnal Details: 


If fd specifies a file that does not currently exist, an indexed 
file is allocated with the specified fd. If fd is the name of a 
file that currently exists, or is the name of the current input 
file, Edit displays the following message: 


DELETE AND REALLOCATE vecln:filename/P? 


If you indicate the file should be deleted by entering YES, Edit 
deletes your file. An indexed file with the specified fd is 
allocated, and current data iS output to that file. Tf you 
indicate that the file shculd not be deleted by entering NO, Edit 
displays the following nessage: 


FILE NCT SAVED 


The editor did not execute the SAVE and outputs a command prompt. 


Tf a previously saved file is saved to an asterisk, or if fd is 
the name of the file being edited, the current data overwrites 
the current input file. The editor displays the following 
message: 


WORKFILE=volin: filename/P 

RENUMBERECD INPUT FILE AVAILABLE, voln:filename/P 
The data is renumbered and is available for further editing. 
When the fd or range parameter is omitted, the entire file is 
Saved. To specify the lines of data to be saved, any combination 
of range arguments is permitted. Edit searches the file for the 
Specified lines or character strings. After a match is made, the 


actual function of the command is performed. 


Data is saved beginning with the first line or string specified, 
continuing through the last line or String Specified. 


To save only the current line, explicitly specify the current 
line number or a unique string in that line. 


Examples: 


PSAVE NEW. EDT 


Save all the Lines to a file named NEWe-EDT on the 
default volume. 
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PSAVE NEW. EDT,1-10 


Save lines 1 threugh 10 to a file named NEW.EDT on the 
default volume. 


POAVE MO7ESNEWSEDT 


Save all the lines to a file named NEW.LEDT on volume 
M678. : 


PSAVE* 


Save the current file to the same filename. 


PSAVE S678 SN EWe EDT g7ACC72Z=7CCASGO 


Save all data frem the line identified by the first 
occurrence of character string ACC tn column 2, to the 
line identified ty character string CCA in column 60 to 
the file NEW.EDT on volume M678. 
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3-24 SCREEN COMMAND 


The SCREEN command displays a full screen of data starting, 
ending, cor centered at the current line. 


Format: 


Parameters: 


48-008 ROO 


6/80 


displays a full Screen 


of data ending at the 


current line. If this parameter is omitted, 


the default is S-. 


displays a full screen 
current line. Tf tris 
the default is S. 


displays a full screen 
current line. 


of data centered at the 
parameter 1s omitted, 


of data starting at the 


2D =a <p a «ap «a 8 oo 
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3-25 SEND STCP COMMAND 


The SEND STOEB command allows the user to halt execution of the 
cucrent command. ; 


Format: 


2SE10 STI 
Fanctional Details: 


The command is only valid during interactive use of the editoc. 


The SEND STOP command is recognized when Edit is executing as a 
foreground task, is the current task, or is a terminal task undec 
an MTA system. 


Enter SEND STOP in response to an operating system prompt. Le 
Edit is currently outsutting to the command device, depress the 
Break key to cbhtain the promet. SEND STOP causes Edit to stoop 
processing the command issued prior to SEND STOP. Edit is now 
ready to acceot the next command. 


3.26 SUBSTITUTE COMMAND 


The SUBSTITUTE command replaces a specified string of data with 


a new string 


of 


data. In a line of data only the first 


occurrence of the string is replaced using this command. 


Format: 


SUBSTITUTE /oldstring/newstring |/ 


line no, } 


mn ced 


Line NO, 


fstrings/7 (co! 


Parameters: 


oldstring 


col 


newstring 


line no, 


line no, 


String, 


string, 


YR-NANAR RAO A/ 80 


is a nen-alphanumeric character delimiting a 
string. The comma, minus sign, blank, 
Semicolon, and any character in the string 
itself cannot be used. 


is a unique character string to be replaced by 
the newstring. 


is a decimal number from 1 to 256 indicating 
the starting column location of the character 
string tc be changed. 


is a unique character string which replaces 
the oldstring. 


is a line number or first line number of a 
range to be searched for the oldstring. 


is the ending line number of a range to be 
searched for the oldstring. 


is a unique character string or first string 
of a range that determines where in the file 
the oldstring Will be replaced by the 
newstring. 


45 the endind Unique character string of the 
range that determines where in the file the 
oldstring will be replaced by the newstring. 


3-45 


col is a decimal number from 1 to 256 indicating 
the Starting column location of string, and 
String>. 


Exaauples: 


>SU /SUB/READ 


Change the first occurrence of the character string SUB 
to the character string READ in the current line. 


>SU eREAD..1- 


Change the first occurrence of the character string READ 
to the null string from line 1 to end-of-file. 


DSU ZSUS7READ//CISC/=7 FILLES 


Change the first occurrence of character string SUB to 
character string READ from the line containing character 
string DISC - to the line containing character string 


PLUE« 
2... A= 
1 A*B=B*A 
2 B*A=A*B 
>SU /A/C/ 1-2 
1 C*B=B*A 
2 B*C=A*B 
DPASAIN 
1 Cr a=3"C 
2 a*CaC*P 
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3.27 TOP COMMAND 


The TOP command changes the current line pointer C5 
line of the file. 


Format: 
TOP 


Examples: 


AL Te 
1 The TOP command 
2 changes the current line pointer 
3 to the first line of the file. 
>TOP 


1 The TCP command 
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the 


first 


| TRUNCATE | 
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3-28 TRUNCATE COMMAND 


The TRUNCATE command truncates a line of data at a specified 
column. 


Parameters: 


col no is the eolunn number aftec which data is 
truncated. If this parameter is omitted, the 
Value of the current truncate column is 


displayed. 
Functional Details: 


The specified column number becomes the point at which characters 
are lost when a line of data is expanded to the right of the 
specified column. If any non-blank characters overflow to the 
right of this column, they are lost, and the following message is 
displayed: 


(NOGN=BLANK CHARACTERS LCST 


When blank characters are truncated, no message is displayed. 
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3.29 TYPE COMMAND 


The TYPE command displays lines of data to the list device. 


Format: 


line no, 
ph 


Parameters: 


Line 10.4 


line no, 


string, 


Strings. 


col. 


Functional Details: 


line Non 


/string,/[col] /string,/[col] 


is the line or first line number of a range of 
lines to be displayed to the list device. 


is the ending line number of the range to be 
displayed to the list device. 


is a nen-alphanumeric character delimiting a 
Str iMG. The comma, blank, minus sign, 
semicolon, and any character in the string 
itself cannot be used. 


is a unique character string or first unique 
character string of a rcange that determines 
what data is to be displayed. 


is the ending unique character string of a 
range that determines what data is to be 
displayed. 


is a decimal number from 1 to 256 indicating 
the starting column of string, and string,. 


When a string parameter is specified, Edit begins searching from 


the line following 


the current line. 


T£ the tab option is in effect, information is displayed 


agrpropriately. 
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Exaa 


ples: 


PELE E 1OF20 


Display lines 10 through 20 of the current file. 


PILePE 3 


Display line 8 of the current file. 


oT EPE: 205 


Display lines 20 through the last line of the current 
£21: b Gy 


P>TYPE 


Display the current line. 


P23 Se es 


Display all lines from the current line through the last 
line of the current file. 

>TYSE/SDISC/-/FILE/S 
Type all lines from the first occurrence of character 
string /DISC/ to the first occurrence of character 
string /ELLE/.« 

DTYPE/SDISC/S3-~/FILE/§50 
Type all lines from the first occurrence of character 


string /DISC/Y in column 3, to the first occurrence of 
the character string /FILE/ in column 60. 
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3-30 PLUS SIGN COMMAND 
The plus sign (+) displays an increment of the current line of a 
file. 
Format: 
+ {n] 


Parameters: 


n is the increment of the current line to pe 
displayed. If this parameter 1S omitted, the 
default is the current line notil. 


Functional Details: 


If the line number parameter is greater than the number of lines 
in the file, then the last line of data is displayed along with 
the following message: 


LAot De 


Exanuples: 


>+ 2 Display the second line following the current 
line. 
>+ Risplay the line following the current line. 
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3.31 MINUS SIGN COMMAND 
The minus sign (~-) displays a Line ecreceding the current line of 
a tite. 
Format: 
=n] 


Parameters: 


n is the line oreceding the current line to be 
displayed. If this parameter is omitted, the 
default is the current line number-?. 


Functional Details: 


If the line number parameter is greater than the number of 
preceding lines in the text, then the first line is output, along 
with the fcllewing message: 


Pieos LNs 


Examples: 


>- Display the line before the current Line. 
>- 4 Disolay the fourth line preceding the current 
line. 
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3-32 LINE NUMBER COMMAND 
Entering a line number by itself can delete, replace, or insert 
a line of data. 
Format: 
n [data] 


Parameters: 


n is a line number. 


data is the data to be inserted or replaced. 
Functional Details: 


Entering a line number followed by data, causes that data to be 
inserted if the line number does not exist. If the line number 
exists, the new data replaces the original data. If a line 
number is specified followed by a carriage return, that line of 
data is deleted. The command is not re-executad by entering the 
AGAIN command. In a Eatch environment, the terminator string 
specified in the OPTION command replaces the carriage return. 


Examples: 

22 Delete line 2. 

>2 ABCD Replace data on line 2 with A8CD. Line 2 is 
now the current line. 

>2.01 EFGH Insert line 2.01 after line 2 with the data 
EFGH arpearing on it. 

>0.0%1 EFGH Inserts a line containing character string 
EFGH on the line preceding the first line of 
a pie ee or After the file is saved and 
renumbered, the line containing character 
string EFGH becomes the first line of the 
ti Le. 
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CHAPTER & 
SAMPLE EDIT SESSION 


The following Edit sessicn was performed in an MTM environment 
that supports accounting. 


>AP 
1 >The standard includes such tigh-performance features 
2 Das capacity for up to 3 of memory, 124 gemeral- 
3 >purpose registers, mjltilevel interrupt structure, 
4 >memory relocation and protection hardware along with a 
§ >8B megabytes/second direct memory access bandwidth, dynamic 
6 Pcomprehensive instruction set. 
7 >a host of performance instruction sets. 
8 >To complement the 3220's inherent power, Perkin-Elmer offers 
9 > 
>BEFORE /includes/processcr /1 
2 The standard processor includes such tigh-performance features 
>AFTER /3/ megabytes/2 
2 as capacity for up to 3 megabytes of memory, 124 gemeral-_ 
>MOVE 6,8 
PTY “S74 
5 8 megabytes/second direct memory access bandwidth, dynamic 
6 comprehensive instruction set. 
6.01 To complement the 3220*°s inherent power, Perkin-Elmer offers 
7 a host of performance instruction sets. : 


>SA ch¥edt.008 

WORK FILE = 4300:CHYEDT.COC/P 

RENUMBERED INPUT FILE AVAILABLE, M300:CH4YEDT.008/P 
>GET CHYEDT.008 


>TY 1- 
1 The standard processor includes such tigh-performance features 
2 as capacity for up to 3 megabytes of memory, 124 gemeral- 
3 Purpose registers, multilevel interrupt structule, 
4 memocy relocation and protection hardware along with a 
S 8B megabytes/second direct memory access bandwidth, dynamic 
6 comprehensive instruction set. 
7 To complement the 3220's inherent power, Perkin-Elmer offers 
8 a host of performance instruction sets. 
>0 TA=/,29 
>O TA 
THE TAB CHARACTER [IS / 
29 
>AP 
9 >Cache Memory/wWritakle Control Store 
10 >Memory Error Logger/Floating Point Processor 
11 >Battery Backup System/Data Handling Instructions 
12 > 
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1 The standard processor includes such tigh-performance features 
p as cacacity for up to 3 megabytes of nemory, 124 gemeral- 
3 purpose registers, multilevel intarrupt structuce, 
4 memocy relocation and grotection Nardware along with a 
5 8 megabytes/second direct memory access bandwidth, dynamic 
6 comprehensive instruction set. 
7 To complement the 3220's inherent power, Perkin-Elmer offers 
8 "a host of performance instruction sets. 
9 Cache Memory Woeitable Control Store 
10 Memory Error Logger Floating Point Processor 
11 Battery Backup System Cata Handling Instructions 
>TOFP 
1 The standard processor includes such tigh-performance features 
>BOTTOM 
11 Rattery Backup System Data Handling Instructions 
2suU /tigh/high/1 
1 The standard orocessor includes such high-performance features 
>CCL 23,/4/,2 
2 as capacity for up to 4 megabytes of nemory, 124 gemercal- 
>FI /gemeral/,i1- 
zZ as capacity for up to Y megabytes of memory, 124 gemeral- 
>CH /meral/,/neral/ 
Z as capacity for up to & negabytes of memory, 124 general- 
DRE 
2 Das capacity for up to 4&8 megabytes of nemorcy, 128 general- 
2-015 
>0 MO=HEX 
20-3 
3 7907572706F7365207265676973746572732C206D756C74606C6576656C20696ET7US 


72757074207374727563747572652C20 202020 20 20202020 2920202020202020202 

>SU /6D75/6D6A 
3 7O7572706F73652072656 7597374657273 2C206DEABCTYEDSECESTESBS56C20696E746 
727579742073749727563747572652C20 202020 20202020 29 202020202020 20 20202 


>O MO=A 
>INC 3,,5 
>TY 1-6 


1 
1 The standard processor includes such high-perfornance features 
2 as capacity for up to 4Y megabytes of nemorcy, 123 general- 
3 purpose cegistears, multilevel interrupt structure, 
3.91 8 negabytes/second direct memory access bandwidth, dynamic 
4 memory celocation and protection hardware along with a 
6 comprehensive instruction set. 
>INS 2 
2-O01>as capacity for up to YU megabytes of memory, 128 general- 
2202> 
>TY 1-3 
1 The standard processor includes such high-performance features 
2 as cacacity for up to 4 megabytes of memory, 128 general- 
2.01 as capacity for up to 4 megabytes of memory, 123 general- 
3 purpose ragisters, multilevel interrupt structure, 


>DEL 2.01 
>TY 1-4 

1 The standard processor includes such high-performance features 

2 as capacity for up to 4 megabytes of neamory, 123 general- 

3 purpese registers, multilevel interrupt structule, 

4 8 megabytes/second direct memory access bandwidth, dynamic 

§ memary relocation and protection hardware along with a 

6 comprehensive instruction set. 
>COL 28,/0/,9-11 

9 Cache “Memory oWritable Control Store 

10 Memory Error Logger OFloating Point Processor 

11 Sattery Sackup Systen oData Handling Instructions 


4-2 48-008 ROO 6/80 


>CH 10/,4/4,9711 : 
9 Cache Memory Writable Control Store 


10 Memory Error Logger Floating Point Processor 
11 Battery Backup Systen Data Handling Instructions 
>SA * 


WORK FILE = M300:CHUYEDT.CO0/P 

RENUMSERED INPUT FILE AVAILABLE, M300:CHUYEDT.008/P 

>G ch4edt.008 

>t 31 

The standard processor includes such high-performance features 
as capacity for up to 4 megabytes of memory, 128 general- 
purpose registers, multilevel interrupt structure, 

8 megabytes/second direct memory access bandwidth, dynamic 
memory relocation and protection hardware along with a 
comprehensive instruction set. 

To complement the 3220's inherent power, Perkin-Elmer offers 
a host of performance instruction sets. 

Cache Memory Woritable Control Store 

Memory Error Logger High Performance Floating Point 
Battery Backup System High Speed Data Handling Instructions 


a O VO WON nM & wh 


—k ob 


>END 
MAUREEN -END CF TASK CODE= 0 CFUTIME=7.313/6.777 
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APPENDIX A 
COMMAND SUMMARY 


line no; 
AFTER /string/newstring |/ 


/string,/ [col] 
line no, 
eects teenth 


AGAIN 
APPEND 
line no, 
BEFCRE /string/newstring|/ 
/string,/[col] 
en Non 
/string,/[col] 
BOTTOM 


CHANGE /oldstring/[col],/newstring/ 


jine no ; 
 ciantliadl 
line no; line nop 
 ecctns, steontf] [\vecsten steal 
line no 
ae 


ee no; re NOn 
ee /string,/[col] 
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COLUNN col no,/string/):, 


line ne; line non 
DELETE - . 
/string,/[col] J StfinGs/ | e51. 


see no 


/string/[(col]) 
FIND /string/[co1] |, 


_ noy an NOn 
pti Jeet /string,/|¢ol} 


mnemonic 
KELP 


line no | 
INCLUDE [fd] 

/string/[col| 

ee no 
Nebel 

ine no, line non 
 jecctes./teant} er: 

line no ] 


LUSERT ane [col] 
| curvent iine / 
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line no 
MOVE 
/string/ [col] 


line no 
Feet 


es no line non 
seasans. Heal ere 


v 


NOFIND /string/ [col] 


n HEXADECIMAL 
QPTION oe , BLOCK | i 4008 |= H | 
ee) ASCIE 


line no 
Vecetns/teantt 


line no; line non 
ee | secctns, reer) 


fd 
saver] [ae| H 
see fd in START command 
fd 
af i 
fd in START connand 


jul {B08 ehar co 14 — 
TAB FORTRAN 
CAL 
string n 
, TERMINATOR - er i senses] + i 
unspecified 23 


48-008 ROO 6/80 


line no, line non 
REPLACE = 
/string,/ [col] | /string,/ [col] 


line no 
Sovanteatl: 


line no; Ve Non 4 
Fs acitaatta jstrings/ (col) 


line no, 


SUBSTITUTE /oldstring/newstring |/ 
| /string,/ [col 


: no, 
/string,/ [col] 
TOP 


TRUNCATE [col no] 


line no, line non 
IYPE = 
/string,/[col] /string,/[col] 


+ [n] 
- [2] 


n [data] 
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DIPLLE BRR LUN, SIZE. oR 


The specified bloc 
block size. 


f{T/O ERR, LUn, code, 


n is 


coie is 


fd is 


LAE 
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APPENDIX B 
MESSAGES 


ROR,fd 


k size exceeds the system maximum 


fd 
the icgical unit (lu) number. 
the error code. See Table B-1. 


the file descriptor. 


De £1 “SY¥CT- ERROR CODES 


| ILLEGAL GR UNASSIGNED LU 

| FARITY OR RECOVERABLE ERROR 
{| UNRECOVERABLE ERROR 

{ ENC OF FILE 

| ENC OF MEDIUM 

} PEeviCe UNAVALTLASLE 

i JLLEGAL FUNCTION 


{IFILE ERR, LUn, code, fd 
n is the lu number. 
code is the error codes. See Table 8-2. 
pare is the file descriptor. 
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data 


TABLE B-2 SYC7 ERROR CODES 


_- <p =e we we «nm oe OR C2 GR ow oe ee ee es ee ee ee ee ee SR oe ee ee ee ee ee eee se ee 


|} ERROR CODE } MEANING 
| of | ILLEGAL FUNCTION 
02 | LU ERROR | 
03 | YOLUME ERROR 3 
| 04 | NAME ERROR 
05 | SIZE ERROR l 
| 06 | PROTECT ERROR | 
07 | PRIVILEGE ERROR l 
| 03 | BUFFER ERROR | 
09 | ASSIGNMENT ERROR 
OA | TYPE ERROR | 
| OB | FILE DESCRIPTOR ERROR | 
oc | TSD ASSIGNMENT ERROR |} 
| OD | ACCOUNT ERROR 


m7 =) ae «= <2 ewe ee ee ee oe ee a ee ow ee ee ee we oe 2 ee Se ee ee 


Ato. SINGS CELE TES 


All lines were deleted from a file using the DELETE command. 


?7COL # WITHIN STRING OPERANCD INVALIC HERE 


A column was specified where it is nat allowed in the command 
Tormat.s 


TCOTUSN ITANCORRECT 


A column was specified where it is not allowed in the conamand 
format. 


?COMMA MISSING 


A comma was missing in the command syntax. 


2COMMAND NCT RECOGNIZED 


The command mnemonic was entered incorrectly. 


CCORSAND GSvVEGS CES ED LOG. bee? 


Command level exceeds that supported by progran. 


RB-2 1a_ nna PAM Fn A on 


DELETE AND REALLOCATE VOLN:s FILENAME /P? 


The file specified in the SAVE command already exists or is 
the name of a current input file. Enter YES if the file is 
to be deleted and reallccated. Enter NO if the file is not 
to be deleted and reallccated. 


PEND CE COMMAND FICE 


ENC 


END 


END 


An EOF condition occurred while reading a command file. 


OF TASK COCDE=0 


Normal completion of a job. 


QF TASK CODE=1 


Abnormal Bie: termination as a result of invalid START 
acguments. 


OF TASK CODF=2 


Execution was terminated as a result of an error encountered 
in batch processing. 


?7FILE NOT FOUND 


The file was not found on the specified volume or the default 
yolume. 


FILE NOT SAYED 


NC was entered in respcnse to the DELETE AND REALLOCATE 
message. 


TFILTENAME INCORRECT 


The filename was entered incorrectly. 


PRIRST LINE 


REL? 


The line number specified exceeds top-of-file. 


PILE PORMAT “ERROR = ABGRTED 


The Helv file format is incorrect. 
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HELP FLLE NOL, EOURD 


The Helo file was not found in the system volume under the 
system account. 


PENVALID BLOCK SIZE 


The specified block size is not in the range allowed. 


2INVALID COLUMN SFECIFIER 


The specified column number is invalid. 


2INVALID HEX CHARACTER 


The specified character string contains an invalid hex 
character. 


fINVALID LIST DEVICE 


The fd specified in the list command cannot be assigned. The 
Original assignment is in effect. 


!INVALID SEND MESSAGE 


An invalid parameter was entered during a send sequence. 


INVALID TRUNCATE VALUE 


An invalid value was specified for the truncate column. 


f{INVALIC OFERAND 
The parameter specified in the SCREEN command is not one of 
WS “e*, or Je eke 

!FILE RECORD LENGTH=m CURRENT LINE LENGTH=n 


The record length of the file specified when a GET command 


Was issued, exceeds the length specified in the OPTION LENGTH 
command. 


oy Wes ae Se 82 


The number specified results in going to end-of-file. 
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(LENGTH CPTLCON NOT ACCEPTED 


The length option was srecified after the SET command. 


{LINE NOT FOUND 


The line or string after which data is to be inserted could 
not be found. 


?7LINE OPERAND INVALID 


The specified line number is invalid. 


!'NON-BLANK CHARACTERS LOST 


The replacement character string exceeds the default number 
of characters per Line. Non-blank characters are truncated. 


PEAT 


An Edit command was entered befcre a file was brought off 
disc via the GET command, or there was no data in the 
allocated file. 


?NUMBER INVALID 


The line parameter is net a numeric character. 


TOCCURS IN ALL DINES 


When executing the NOFINCD command, the specified character 
string to be searched fcr was found inall lines. 


fOPTION ERROR FOLLOWS XXKXX 


The characters appearing in place of xxxx are the last four 
non-blank characters recognized as valid. An OPTION 
parameter was not valid. 


fRANGE 1 NOT FOUND 


The lower limit of the range could not be found. 


fRANGE 2 NOT FOUND 


The upper limit of the range could not be found. 


?7RANGE INVALIC 


The specified range was entered incorrectly. 


PREMNDUCER = SAVE POUR “CURRENT. TEAT 


An END or another GET command was entered before entering a 
SAVE of current data. 


7REFEAT DISALLOWED 


The DELETE, END, GET commands, and a line of data entered 
with a line number are not rer-executed by antering a carriage 
return. 


POCReln Si2e. FAVA 


The number of lines specified fer screen size is invalid. 


CST RING. LAVAL LL 


The specified character string was entered incorrectly. 


(STRING NOT FOUND 


The character string was not found within the specified 
range. 


{TAB ILLEGAL 


An illegal tab setting was specified, or an illegal tab 
character was used. 


TABS. TASLE FULL 


There are more than 20 tab settings. 


{TRUNCATE VALUE INVALID 


There is an invalid value specified for the truncate column. 
27UNABLE TO LIST FULL SCREEN 


There is insufficient data in the file to list a full screen 
as requested in the SCREEN command. 


B-6 BR8=-A008 RAN K/A0 


APPENDIX C 
ASCII - EECLIC CONVERSION TABLES 


CARD eee a eae 


a eee 
ae 


| A | 12-1 44 | CA 
B } 12-2 | 42 | C2 
| C | 12-3 | u3 «| C3 
| D ! 12-4 Gu | C4 
| E f 12-5 | 4u5 | C3 
| F 26 | 4H | C6 
| G |: 27 | G7 | C7 
| H | 12-8 | 48 | Ga 
| I | 12-9 | 49 | C9 
| J ae oe 4A | D1 
K t. AZ | 4B D2 
| L {| 11-3 | uC | D3 
| M | 11-4 YD | D4 
| N Pr 41=5 | YE DS 
| e | 11-6 | YF D6 
| P Le 7 | 50s D7 
Q | 11-8 | 51 | D8 
| R | V1=28 | 52 | DY 
| S } O-2 a3. 4 EZ 
| a { O-3 ae E23 
| U | O-4 25 | EY 
| V | Os 56: | ie. 
| W | 0-6 | 57 | E56 
| X Y O=7 | 58 | E7 
| i | 0-8 | 59 | E8 
| Z } O-9 | 5A | E9 
| a ee ee re 
| Lowercase Letters 

| ee 
a [A220] | 61 8 1 
b Pi2-0= 2 | 62 | 82 
c br Z=0=3 | 63 | 83 
d {12-0-4 | 64 | 84 
| e rj2 Oss | 65 | 85 
| f |12-0-6 | 66 | 86 
| 9 PiZ2=oe7 67 | 387 
| h LA20=6 68 | 88 
i [i2=o=9 69 | 89 
3 Pt2S3i—1 | 6A | 91 
k es a ce | 6B | 92 
| 1 2) 8 6c. | 93 


URK-OANR RNO RIAD 


wee fe ieee em OR Ue vee eee OE epee (OE meen See (fetes ee cee (Slee aeons «cee NER eee “OR ee eee ene “OE 


Ammen eT | teh 


Cerne A eee ey 


oe «ae <<) <a ow ae a a oe ee ee ae oe 2 ee ee ee ee ee ee ee ee es ae es ee ee oe eee eae ee ee es es ee ae 


eeteh «etme Te 


N“4 * £C es crn nn OOD yg 


lExelamation Point 
[Quotation mack, 
jdieresis 
|Number sign, 
{Dollar sign 
[Percent sign 
| Ampersand 
J|Apostroche, 
Jaccent 


acute 


|Cpening parenthesis 
{Closing parenthesis 


{Asterisk 

[Plus sign 
{Comma, cedilla 
{Minus sign, 
| Period, 
{Slash, 
Colon 
{Semicolon 


virgule, 


hyphen 
decimal point 
solidus / 


round sign # 


| 
CARD 


[12-11-38 
112-11-9 
111-0-2 
[11-0-3 
111-0-4 


wh ~h od db 


ASCII | EBCDIC 
HEXADECIMAL 
6D | 94 
E | 95 
6F | 96 
70° - 6 ag 
74 | 98 
72 | 99 
73} A2 
7 | AB 
75 | AG 
76 | AS 
77 | AB 
78 | AT 
79 «| AB 
7A | AQ 
30 | FO 
31 | FI 
32 | F2 
33 |) P3 
34 | Fu 
35 | FS 
36 | £6 
37 «| FI 
38 | F8 
39 | Fg 
5D | SA 
| 
22 4 FF 
23 | 7B 
24 | 5B 
25 | 6c 
26 | 50 
| 
a7 | FD 
283 | 4D 
29 | 5D 
2A |  5C 
2B | 4E 
2c | 62 
2D | 60 
2E | 4B 
Oe 4 (ee 
3A | 7A, 
3B | SE 


HRmANR RON 


eer ne err ee ee 


A/&8O0 


anawe«dan@p «mp @wwe«q@«e we ane @ «se <= wew<<*7 @ @ eo ae ~eean weaw«@anweqweaweew«a@ == <e «2 <2 <=> as 2m ew ame oe oe as em a em ap ow as ap «2 aw «<» 


|Less than 
[Equal sign 
|}Greater than 
{Question mark 
{Commercial at symbol 
[Opening bracket 
{Closing bracket 
|Reverse slash 
{Circumflex 
{Underline 
{Grave accent 
{Opening brace 
{Closing brace 
{\Yertical line 
{;Overline, tilde 


nw sw ase «Pe wee ~@2)_ese 2] ee Pe eee ee See lee Ue Cee eee eee ee Seer eee See eee eee eer ew eee eee ee eee eee eee eee eee ee eee eee eel ee oe ee lee 


JACK (acknowledge) 
JBEL (bell) 

|BS (backspace) 

{CAN (cancel) 

{CR (carriage return) 
{|DC1 (device control 
[DC2 (device control 
[DC3 (device control 
1DC4Y (device control 
{CEL (delete) 

{DLE 
{EM Cend of medium) 
{ENQ Cenquiry) 


ee, 
2) 
3) 
4 ) 


(data link escape) 


[ECT (end of transmissicn) 


JESC (escape) 


[ETB (Cend of transmissicn 


{block ) 

{ETX (end of text) 
{FE (form feed) 

lFS (file separator) 
IGS (group separator) 
{HT 


[LF (line feed) 


|INAK (negative acknowledge) 


pROL. (noth) 
IRS 
ISI (shift in) 
[SC (shitt- owt) 


(record Separator) 


[SCH (start of heading) 


[SP (space) 
(STK CStatrt of text) 


(horizontal tabulaticn) 


| 
| CARD 


— >» ow 
i 


pas 


a ae Hee CON ate ee OO ee ee ee ee aie see SEPT jee 


TS ae ee eee 


Ow > —s or 
PtOerwV DN WO ow Oh) am 32 OO 
' 
www O MWOWMO wOWWOO WO WO WO 
( 
mm ! YN & lw bt = © WO DN @w OO 


foe ren ree ae eee: | 
1 
n& & 


Norn -~N WOON = 2 NHN O 
! 
OwoOwowoowmvwvnwowowonwvoww 
t 
+~ OO OM) WW UI® © OWN 


' 
ok 


a ee eee es eee Y 
i 
{ 
nN ~~) ov © 


ack 
NO 
! 
OO 
! 
NO 


ASCII | EBCDIC 
HEXADECIMAL 
sc Cf 
3D |] TE 
3E | £6€ 
3F {| 6F 
uo | 7C¢ 
SB | 4A 
21 | UF 
5C | £0 
SE | SF 
SF | 6D 
60 | 79 
7B {| CO 
7D | dO 
Te eR 
7E | At 
06 | 2E 
OF | 2 
08 | 16 
18 | 18 
OD |} OD 
a a 
12 | 12 
13 | 13 
‘a. £ $e 
JF | 07 
fo +. 40 
19 | 19 
05 | 2D 
O4u | 37 
1B |) 
| 
17 | 26 
03 | 03 
oc: oC 
1c 4 -FC 
1D | 1D 
09 } OS 
OA | 25 
15 | 3D 
00 | oO 
1E J E 
OF | OF 
OF | OF 
OF -. 205 
20° i Go 
62 4+ 02 


en ee ee SO ah ae OOP ae ene OO see eee EP ae eee 


ees i ON ll ee SO ee ER ee ei Stee (To Se ee ue ee ements OM ey eee OO eee mene GRID cpt Ste tent a 


—_ = <n <) =e ae oe 8 ee oe <e aw oe oe ee eo ew ee ee ee ee ee ae ee ee eee ee eee ee ee 


| | 
| | CARD - [ween ere er eee -- | 
| 


{SUB (substitute) | 9-8-7 | 1A | 3F | 
ISYN (synchroncus idle) | 9-2 { 16 | 32 | 
{US (unit separator) f11-9-8-7 TE 4 1F | 
IVT (vertical tabulation) [12-9-8-3 | OB | 03 | 


mm = 7m << = <= «a «ah ae oe ae 6 oe ee ee ee Oe ee ee ee ee ee ee oe «ee ee Om ee ee ee ee ee ee ee ee ee ee ee a ae ee ee ee ae ee ee ee ets es 


{edt HOLLAND? ANA 2san 


AFTER command, 3-2 

AGAIN command, 3-4 

APPEND command, 3-5 

ASCII and hexadecimal editing, 
ASCII-EBCDIC conversion tables, 
ASCII mode, 1-4 


Background task, 1-3 
Batch processing, 1-3 
BEFORE command, 3-6 
Block size, 3-31, 3-33 
BOTTCM command, 3-8 
Break Key, 3-44 
Building Edit, 2-1 


Carriage return, 1-2, i-7, 
CHANGE comrmand, 3-9 
Character strings, 1-5 
COLUMN command, 3-11 
Column display, 1-9 
specification, 3-33 
Command 
files, 3-31, 3-33 
mode, 1-1, 172, 3-32 
prompt, 1-2, 3-41 
Commands 
AFTER, 3-2 
AGAIN, 3-4 
APPEND, 3- 
BEFORE, 3- 
BOTTOM, 3- 
CHANGE, 3- 
CCLUMN, 3 
DELETE, 3- 
DONE, 3-15 
END, 3-16 
FIND, 3-17 
GET, 3-19 
HELP, 3-21 
INCLUDE, 3-22 
INSESTs 3-25 
LINE NUMBER, 3-53 
MINUS SIGN, 3-52 
MCYE, 3-27 
NOFIND, 3-29 
OPTION, 3-31 
PAUSE, 3-36 
PLUS SIGN, 3-51 
REPLACE, 3-37 
RULER, 3-39 
SAVE, 3-490 
SCREEN, 3-43 
SEND STOP, 3-44 
SUBSTITUTE » 3-85 
TOP, 3-47 
TRUNCATE, 3-48 
TYPE, 3-49 


—_ 


4 


wb bt (LO OC DN UN 
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1-4 
C-1 


INDEX 


Command summatry, 
Control characters, 1-2 


Control 
CTRL H, 
CIEL X, 


I, 3-34 
2 
1-2 


Control cptions, 
Current line, 1-5 


DELETE command, 3 
Delimiters, 1-6 

Disc devices, 1-1 
DONE command, 3-1 


A-1 


2-331 


=13 


5 


Edit command syntax, 179 
Edit features, 1- 


Edit load 


module, 


4 
2-2 


Edit requirements, 1-1 
Edit session, 4-1 
END command, 3-16 


File 


class, 1-4 
descriptors, i- 
group, 1-4 


private, 
system, 
Filenane, 


FIND command, 


3 
1-4 
1-4 
1-4 
35:47 
1-8 


Formatting data, 


GET command, 3-19 
Group file, 1-4 


HELP command, 3-2 


Hex editin 
Hexadecima 


Gy, 3-33 
1, 1-4, 


Identifying data, 
INCLUDE command, 
Input mode, 1-1, 


INSERT command, 


Interactive 


command mode, 


input mode, i-1 
Interactive, 3-4, 


Line 
length, 
number, 


per screen, 


4 


3-319. 323-3 
1-4 

I= 22 

1-2, 3*8 


3225 


14 


ee 


1-8, 363-5 3-10 


1-4 


Eee Be 


LINE NUMBER command, 3-53 


Ind-1 


INDE 
Loading Edit, 2-1, 2-2 Ranges, 1-4 
from an 4TM terninal, 2-1 REPLACE command, 3-37 
from the systems console, 2-2 ROLER command, 3-39 
Messages, 1-11, 8-1 Sample Sdit session, 4-1 
MINUS SIGN command, 3-52 SAVE command, 3-40 
fode SCREEN command, 3-43 
ASCII, 1-4 SENC STOP command, 3-44 
command, i-1, 1-2 Starting Edit, 2-3 
hexadecimal, 1-4 Statement syntax conventicns, 1-9 
input, 1*1, 1~2 SUBSTITUTE command, 3-45 
MOVE command, 3-27 System environments, 1-1 


System file, 1-4 


NMOFIND command, 3-29 
Null line, 1-2 Tab 
character, 37-32, 3-33 
settings, 178, 3-32 
Ogerating system proapt, 3-44 Tabulation points, 3-33 
CETICN command, 3-31 Temporary file support, 1-1 
Terminator, 3-32, 3-34 
Text display, 1-8 


PAUSE command, 3-736 TOP command, 3-47 
PLUS SIGN command, 3-51 TRUNCATE command, 3-48 
Private file, 1-4 TYPE command, 3-49 


Prompts, J=2 
command, 1-2 
greater than sign, 1-2 Yerification, 1-9 
line, 12 
Operating system, 3-44 
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